home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / nt / ntunzip2.zip / INSTALL < prev    next >
Text File  |  1994-01-23  |  7KB  |  133 lines
  1. Info-ZIP file INSTALL for UnZip
  2.  
  3.  
  4. Compile:
  5.  
  6.   - Unpack *.c, *.h, preserving directory structure (e.g., ./unix/unix.c);
  7.     exception is TOPS-20, where tops20/* should be unpacked into current
  8.     dir.  Copy appropriate makefile into current dir and/or rename as
  9.     appropriate.  (Some makefiles can be invoked in place--e.g., "nmake
  10.     -f msdos\makefile.msc" or "make -f unix/Makefile some_unix_target"--
  11.     but MS-DOS targets in Unix makefile [bcc_dos, gcc_dos, etc.] cannot.
  12.     Also, moving the Unix Makefile instead of copying it will result in
  13.     a harmless error message at compile time.)
  14.  
  15.   - If you want a non-standard version, define one or more of the following
  16.     optional macros.  These may not be fully supported in future releases,
  17.     however.
  18.  
  19.       OLD_EXDIR    (Unix, OS/2, MS-DOS only)
  20.         Old behavior regarding the directory to which to extract:  argument
  21.         immediately after zipfile name is extract-to dir; if dir doesn't
  22.         exist, create if specified as "dir/" (i.e., with trailing path
  23.         separator), else treat as stored file; if -d option used, treat
  24.         argument as stored file regardless of trailing '/'.  For example:
  25.             unzip foo bar       if bar is a dir, extract everything into it;
  26.                                 otherwise extract bar as stored file
  27.             unzip foo bar/      extract everything into bar, creating if nec.
  28.             unzip -d foo bar/   treat bar/ as a stored directory and extract
  29.  
  30.       DOSWILD      (MS-DOS only)
  31.         Treat trailing "*.*" like Unix "*" (i.e., matches anything); treat
  32.         trailing "*." as match for files without a dot (i.e., matches anything,
  33.         as long as no dots in name).  Special treatment only occurs if patterns
  34.         are at end of arguments; i.e., "a*.*" matches all files starting with
  35.         "a", but "*.*c" matches all files ending in "c" *only* if they have a
  36.         dot somewhere before the "c".  Thus "*.*.*" could be used (albeit awk-
  37.         wardly) to specify all filenames with at least one dot in them, and
  38.         "*." matches all filenames with no dots in them.  [The default method
  39.         of specifying these would be "*.*" and "* -x *.*", respectively, where
  40.         the second example makes use of UnZip's exclude-files option.]  All
  41.         other regular expressions (including "?" and "[range_of_chars]") re-
  42.         tain their Unix-like behavior.
  43.  
  44.       CHECK_VERSIONS (VMS only)
  45.         UnZip "extra fields" are used to store VMS (RMS) filesystem info,
  46.     and the format of this information may differ in various versions
  47.     of VMS.  Defining this option will enable UnZip warnings when the
  48.     stored extra-field VMS version(s) do(es) not match the version of
  49.     VMS currently being used.  This is a common occurrence in zipfiles 
  50.     received from other sites, but since the format of the filesystem
  51.     does not seem to have changed in years (including on Alpha and Open-
  52.     VMS systems), the warnings are not enabled by default.
  53.  
  54.       RETURN_CODES (VMS only)
  55.         VMS interprets return codes according to a rigid set of guidelines,
  56.         so VMS UnZip always returns 0 regardless of whether any warnings or
  57.         errors occurred.  To see the UnZip return values, define RETURN_CODES;
  58.         UnZip will then print the value and its interpretation.  This is often
  59.         annoying, however.
  60.  
  61.       NO_ZIPINFO
  62.         Compile without zipinfo mode (-Z) enabled; makes smaller executable
  63.         because many text strings left out.  Automatically enabled for
  64.         small-model compiles under MS-DOS and OS/2, so ordinarily there is
  65.         no need to specify this explicitly.
  66.  
  67.       CHECK_EOF (primarily intended for MS-DOS)
  68.         When unzipping an archive on a bad floppy drive, unzip reportedly
  69.         hangs the system; this appears to be due to a failure to do a proper
  70.         check for end-of-file from the read() system call.  Defining CHECK_EOF
  71.         enables better checking; this option is not on by default because it
  72.         was introduced too late in the testing process.
  73.  
  74.       DEBUG
  75.         Used for debugging purposes; enables Trace() statements.  Generally
  76.         best to compile only a single module this way.
  77.  
  78.   - If you regularly compile new versions of UnZip and always want the same
  79.     non-standard option(s), add it (them) to the LOCAL_UNZIP environment
  80.     variable.  Under MS-DOS, for example:
  81.  
  82.         set LOCAL_UNZIP -DDOSWILD -DOLD_EXDIR
  83.  
  84.     Can also use variable to hold special compiler options (e.g., -FPi87
  85.     for Microsoft C, if x87 libraries are the only ones on your disk and
  86.     they follow MS's default naming conventions).
  87.  
  88.   - Choose appropriate makefile based on description in <OS>/Contents file;
  89.     move or copy into the current directory and possibly rename; edit to
  90.     include any special macros (e.g., add -DDOSWILD to CFLAGS) or whatever
  91.     (see special OS-specific notes below); and run the relevant "make" utility
  92.     as appropriate.
  93.  
  94.       VMS
  95.         For a one-time make, one can simply run the supplied command file.
  96.     To use either DEC C on an Alpha or VAX C on a VAX, simply type
  97.     "@make" (after copying make.com into the current directory; other-
  98.     wise do "@[.vms]make").  To use GNU C (gcc) on either platform, do
  99.     "@make gcc".
  100.  
  101.         For repeated makes or other hacker-like tinkering with the sources,
  102.         use one of the included makefiles.  With DEC's MMS or the free MMK
  103.         clone, copy descrip.mms into the current directory and run MMS or
  104.         MMK.  Otherwise grab Todd Aven's free MAKE/VMS, copy makefile into
  105.         the current dir and run make.
  106.  
  107.         Sources to Rahul Dhesi's BILF (binary/line-feed) program are also
  108.         included as a convenience; it can be useful for converting between
  109.         stream-LF and fixed-length-512 formats.  Further information is in
  110.         the program comments.
  111.  
  112.   - 
  113.  
  114.  
  115. Install:
  116.  
  117.   - Unix:  edit Makefile if manext (man-page extension, usually "1"), MANDIR
  118.     and BINDIR are not correct; then do "make install"
  119.  
  120.   - VMS:  install UnZip as foreign symbol by adding this to login.com:
  121.        $ unzip == "$disk:[dir]unzip.exe"
  122.        $ zipinfo == "$disk:[dir]unzip.exe -Z"
  123.     where "disk" and "dir" are location of UnZip executable; "$" before
  124.     disk name is important.  Some people, including the author, prefer a
  125.     short alias such as "ii" instead of "zipinfo"; edit to taste.  See
  126.     vms/README for notes/warnings about zipfiles and UnZip under VMS.
  127.  
  128.   - OS/2, MS-DOS, NT:  move or copy unzip.exe to a directory in your path;
  129.     also possibly copy unzip.exe to zipinfo.exe (or ii.exe), or else create
  130.     a batch file for zipinfo ("@unzip -Z %1 %2  etc.")--only relevant if
  131.     zipinfo mode is enabled, obviously...
  132.  
  133.